home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr13 / alist112.zip / COLRTEXT.COL < prev   
Text File  |  1995-02-03  |  11KB  |  230 lines
  1.                     ┌─┐
  2.    î ┌──────┐ ┌──────┤ │   ┌─────┐  è┌────────┐┌───────┐┌────┐ ┌────┐┌────────┐
  3.  ä  ┌┘ ┌────┘ │ ┌──┐ │ │   │┌──┐ └┐ è│┌─┐  ┌─┐│└┐ ┌───┐│└─┐ ┌┘ └┐ ┌─┘│┌─┐  ┌─┐│
  4.  ì ┌┘ ┌┘     ┌┘┌┘ ┌┘ │ │   ││  └─┐└┐è└┘ │  │ └┘ │ │ ┌┐└┘  └┐└┐ ┌┘┌┘  └┘ │  │ └┘
  5.   à│  │      │ │  │  │ │   ││   ┌┘ │  è │  │    │ └─┘│     └┐└─┘┌┘      │  │ ï┌┐
  6.   å│  │      │ │  │ ┌┘ │   │└───┘ ┌┘  è │  │    │ ┌─┐│      │   │       │  │ ï└┘
  7.  ê │  │      │ │  │ │  │   │     ┌┘   è │  │    │ │ └┘┌┐   ┌┘┌─┐└┐      │  │ ï┌┐
  8.  Ä │  │      │ │  │ │  └───┴┐┌┐  └┐   è │  │    │ │   ││  ┌┘┌┘ └┐└┐     │  │ ï││
  9.   Å│  └─────┐│ └──┘ ├┐      ││└┐  └┐ è ┌┘  └┐  ┌┘ └───┘│┌─┘ └┐ ┌┘ └─┐  ┌┘  └┐ï└┘
  10.  ï └────────┘└──────┘└──────┴┘ └───┘ è └────┘  └───────┘└────┘ └────┘  └────┘
  11.                         Paint your texts
  12.  
  13. Å COLRTEXT v 0.98     27.2.95
  14. Å═════════════════════════════  by ïWalter Gamba
  15.  
  16. ïCOLRTEXT is a small, but fast, text viewer and "painter". It has, as one can
  17. guess from the name, ANSI capabilities, i.e. it can display text with embedded
  18. ANSI escape sequences or a very simple color codes. It does not need ANSI.SYS,
  19. of course.
  20. Using the Mouse, one can apply colour over a text file, save it and view it
  21. using both ïCOLRTEXT or its smaller companion ïANSILIST (version 1.12 up).
  22. ïCOLRTEXT is shareware, but cheap. Pleas read the Shareware notice.
  23.             ─────────
  24.  
  25. ÅNOTE & DISCLAIMER
  26. Å─────────────────
  27. ÅPlease note that if you choose to paint the text file, and you decide to save
  28. your work, the original text file will be overwritten with the text+embedded
  29. colour sequences.
  30. I do not guarantee that te saved file will not be corrupted, or made unreadable.
  31. So I suggest you to work always on a back-up ed copy of a file.
  32.  
  33. Å file list
  34. Å───────────────
  35. ÅYour ZIP file must contain the following:
  36. ÅCOLRTEXT.EXE    the exe file
  37. ÅCOLRTEXT.DOC    this doc
  38. ÅHUNGBOOK.TXT    the test file
  39.  
  40.  
  41. If you know ïANSILIST you will find ïCOLRTEXT very similar.
  42. If you are interested in ïANSILIST (same as ïCOLRTEXT but with no painting
  43. facilities) search for ALISTXXX.ZIP.
  44.  
  45. Å HOW TO RUN IT
  46. Å───────────────
  47. ÅIf you want to use the colouring facilities of ïCOLRTEXT you must load, before
  48. running it, a Microsoft Mouse compatible driver.
  49. To run ïCOLRTEXT simply type on the command line:
  50. >>ïCOLRTEXT filelame [/t] [/c]
  51.  
  52. "filename" is the name of the file you want to view or colour. It can list files
  53. with up to 650,000 lines..
  54.         î/t      will force COLRTEXT to start in plain text mode (by default it
  55.                 starts in ANSI mode).
  56.         î/c      will force it to start in ClearScreen mode (by default
  57.                 the ClearScreen mode is turned off).
  58.  
  59. îANSI mode: the ability to read end interprete ansi escape sequences and
  60.            my simple color coding scheme. When it is turned off escapes are
  61.            treated as normal text and it is not possible to colour text.
  62. îClearScreen mode: in this mode, before every screen update, the program will
  63.                   wipe off the screen. If this is turned off it won't.
  64. Read the ANSI section for details.
  65.  
  66. Typing ïCOLRTEXT alone will bring up a concise help.
  67.  
  68. ÅANSITEXT Screen:
  69. Å────────────────
  70. ÅYou will be presented with the first page of the document.
  71. At the bottom of the screen a Status Bar will contain (from right to left):
  72.  
  73.         -the name of the file you're viewing
  74.         -the Ansi status          (read the Ansi section)
  75.         -the Clearscreen status   (read the Ansi section)
  76.         -the number of the line displayed in the upper row of the screen
  77.         -the percentage of the text yo've already viewed (including the current
  78.                                                           page)
  79.         -the îcurrent painting colour, in the form  èCol .
  80.         -theî color palette, allowing you to choose between the standard 16
  81.          colours.
  82.  
  83. ÅCommands:
  84. Å─────────
  85. ÅWhile viewing a text you can use the following keys:
  86.  
  87. îSPACE/ENTER/PGDWN       view next page
  88.              îPGUP       view previous page
  89.  
  90.              îHOME       moves to the beginning of the file
  91.               îEND       moves to the last page of the file
  92.  
  93.               îDWN       view one line down
  94.                îUP       view one liine up
  95.  
  96.              îLEFT       view current page, one char to the left
  97.             îRIGHT       view current page, one char on th right
  98.  
  99.                 îA       toggle ANSI interpreter on/off
  100.                 îC       toggle ClearScreen status
  101.  
  102.            Only Registered version:
  103.                 îF       find a string in the file, from current position.
  104.                         matches ignoring case.
  105.                 îN       find next occurrence of the string
  106.  
  107.                 îL       load another file
  108.  
  109.  
  110.            In both versions:
  111.  
  112.               îESC       quit COLRTEXT
  113.  
  114. When prompted with error messages hit a key to resume.
  115.  
  116. ÅHow to paint text files
  117. Å───────────────────────
  118. ÅIf you have a mouse driver loaded, and you have turned ANSI capabilities on,
  119. you can îpaint text using the standard EGA colours.
  120. Normal text is coloured in Light Gray, and the background is always black.
  121. îJust choose the colour you want by clicking the left mouse button on the
  122. appropriate `'. You will see the colour you have selected appear between
  123. the two arrows `' and `'.
  124. Then point at the first character of the text you want to paint, îpress and
  125. îkeep pressed the left mouse button and move the mouse pointer until you have
  126. îselected the text (it will appear in a different colour). When you have
  127. selected exactly the piece of text you want to paint, release the mouse button.
  128. The text will then appear in the colour you have chosen.
  129.  
  130. ÅCOLRTEXT & ANSI files.
  131. Å──────────────────────
  132. ÅThe texts this program was at first intended to work with were text files
  133. with ANSI esacape sequeneces which specified colour. This kind of text is
  134. very much similar to plain text, i.e. one line in the file corresponds to
  135. exactly one line on the screen. When I decided to implement all the other
  136. escape sequences, in order to be able to view ANSI drawings, I had some
  137. problems, mainly because an ansi file has not a one-to-one mapping between
  138. file lines and screen lines.
  139. When viewing large ansi file I suggest to use only the PGUP/PGDWN keys,
  140. since in an ansi file with embedded screen coordinates it is rarely effective
  141. to read the next file line hoping to see the drawing scrolling one line.
  142. This is because usually in ansi files it takes several lines in the file to
  143. specify one line on the screen.
  144. Moreover, since ansi drawing is not sequencial, but can move the cursor
  145. everywhere, sometimes portions of the screen are left untouched (and
  146. supposed black). Since we are using a text viewer, the screen is always
  147. covered with characters and rarely empty. That's why I included the option
  148. of clearing the screen before any screen update( i.e. before any movement
  149. command). One can toggle this function on and off with the C key.
  150. This function is useless when viewing files in plain text mode.
  151.  
  152. ÅWhy an ANSI file viewer?
  153. Å────────────────────────
  154. ÅI was bored to use "type moo.ans" to view files with ansi escapes. When I
  155. discovered GnuAWK and used it to colour up some text, I needed one to check
  156. my work easily, scrolling up and down etc..
  157. I include a ìMonty Python's sketch -èThe Hungarian Phrasebookç-, coloured so as
  158. çto be more readable,as a test of the ANSI capabilities of this tiny software.
  159. Should you be interested, I have some little ïGAWK script able to turn a
  160. screenplay in a coloured screenplayin many ways. Just E-Mail me.
  161. I include this .DOC file painte with ïCOLRTEXT as an example of what can be done.
  162.  
  163.  
  164. ÅWhy my simple colour coding scheme
  165. Å──────────────────────────────────
  166. ÅI included in ïCOLRTEXT, and in the new version of ïANSILIST ( >1.12),the ability
  167. to interprete a simpeler color coding scheme, consisting of two bytes,
  168. one for the escape, the other for the color attribute. It was much more
  169. simple and faster to handle files this way.
  170. The escape sequence is made of two bytes: é0x01 éATTR
  171.         where éATTR is a screen color attribute (as used in the Video Ram )
  172.         ored with ë0x80.
  173.         if éATTR is ë0xFF this escape sequence will restore the colour used
  174.         before the previous `normal' escape sequence.
  175.  
  176. ÅNote about painting texts
  177. Å─────────────────────────
  178. ÅThe algorithm I have used to allow painting of text keeps every new "painting"
  179. in memory, in order to work quickly. I hope to have attained this effect. Since
  180. I have not fully optimized it, I have chosen to save the file every 100 paint
  181. strokes added, then to reload it and continue working until yhe next 100 strokes
  182. and so on. That's why sometimes you will be asked to save and reload the file.
  183. Just to free up some memory and thus to work faster.
  184. Actually I don't know yet how far this limit can be raised, I think 500 strokes
  185. could work well, but I need time to test it.
  186.  
  187.  Å         BUGS REPORT
  188. Å ──────────────────────────────
  189. Since this is my first release, it is possible that my program has some bugs.
  190. Even if you are not registered, it would be very useful to report any bug
  191. to me (possibly via E-Mail). Thanx.
  192.  
  193. Å        SHAREWARE NOTICE
  194. Å ──────────────────────────────
  195. ÅîThis program is not free, since it costed me many hours of tough coding and
  196. testing.
  197. îIf you find it useful and if you keep on using it after a trial period of 23
  198. îdays tou should register.
  199. To register just send meî 5$ (French Francs and Italian Lire of the roughly
  200. same value are OK), specifying your E-Mail address.
  201. I will then mail you the latest uuencoded release. If you don't have an E-Mail
  202. you can include a SASE. Remember to specify if your computer can read 720K disks
  203. (which are cheaper :) ). I will then ship you the disk with the registered
  204. version.
  205. îIt is a small fee, but it will help me improve COLRTEXT and my many other.
  206. projects. Remember to specify if your computer can read 720K disks (which
  207. are cheaper :) ). I will ship you the disk with the registered version which
  208. include some facilities not implemented in the shareware version.
  209.  
  210. Å       REDISTRIBUTION
  211. Å ─────────────────────────
  212. ÅYou may freely redistribute this software as long as you don't alter it and you
  213. keep the ZIP package unaltered. All disclaimers and legal stuff as usual...
  214.  
  215. My address is:
  216. è        Walter Gamba
  217. è        via Torricelli 36
  218. è        10129 Torino
  219. è        ITALY
  220. è
  221.         éE-Mail: îIPER1@îpol90a.îpolito.îit
  222.  
  223. Ä        ╒═╕╒═╕╒═══╕╒═╤═╕   ╒════╤═══╕╒═╕╒═══╕  ╒═╕
  224. ÄÅ        │ ╘╛ ╞╛╒═╕╘╡ │ │   │ ╒══╡ ╒╕╘╡ ││ ═╤╛  │ │
  225. ÅÅ        │    │ ╘═╛ │ │ ╘═╕ │ ╘═╕│ ╘╛╒╡ │╘═╕╘╕  │ │
  226. Å        │ ╒╕ │ ╒═╕ │ │   │ │  ═╧╡ ╒╕╘╡ ╞══╛╒╛  ╞═╡
  227.         ╘═╛╘═╧═╛ ╘═╧═╧═══╛ ╘════╧═╛│ ╞═╧═══╛   ╘═╛
  228.                                    ╘═╛
  229.  
  230.